---
title: Install & Setup
---

## Install Agno

We highly recommend:

- Installing `agno` using `pip` in a python virtual environment.
- Creating an `ai` directory for your ai infra

<Steps>
  <Step title="Create a virtual environment">
    Open the `Terminal` and create an `ai` directory with a python virtual environment.

    <CodeGroup>

    ```bash Mac
    mkdir ai && cd ai

    python3 -m venv aienv
    source aienv/bin/activate
    ```

    ```bash Windows
    mkdir ai; cd ai

    python3 -m venv aienv
    aienv/scripts/activate
    ```

    </CodeGroup>

  </Step>
  <Step title="Install Agno">
    Install `agno` using pip

    <CodeGroup>

    ```bash Mac
    pip install -U agno
    ```

    ```bash Windows
    pip install -U agno
    ```

    </CodeGroup>

  </Step>
  <Step title="Install Docker">
    Install [docker desktop](https://docs.docker.com/desktop/install/mac-install/) to run apps locally
  </Step>
</Steps>

<br />

<Note>

If you encounter errors, try updating pip using `python -m pip install --upgrade pip`

</Note>

---

## Upgrade Agno

To upgrade `agno`, run this in your virtual environment

```bash
pip install -U agno --no-cache-dir
```
